package javax.servlet;

import java.util.Enumeration;



/**
 * 
 * servlet初始化阶段用于存储servlet的配置信息,作为存储servlet配置信息的对象,
 * 它就可以被servlet容器调用,以便实现消息向另一个servlet传递这个过程. 
 *
 */
 
public interface ServletConfig {
    

    /**
     * 返回当前servlet实例的名称.
     * servlet实例的名称可以是服务器管理员提供的,名称由Web项目的部署描述符指定;
     * 如果servlet类的实例未注册到项目部署描述符中(因此没有部署描述符名称),
     * 缺省情况下将返回servlet的类名.
     *
     * @return		servlet实例的名称
     *
     *
     *
     */

    public String getServletName();

    /**
     * 返回当前运行环境下{@link ServletContext}的引用.
     *
     *
     * @return		{@link ServletContext}对象,调用者使用它实现对servlet容器的交互.
     *  			
     * 
     * @see		ServletContext
     *
     */

    public ServletContext getServletContext();
    
    /**
     * 返回名为name的初始化参数值.如果不存在指定的参数名,则返回 <code>null</code>.
     *
     * @param name	初始化参数的名称
     *
     * @return		初始化参数的值
     *
     */

    public String getInitParameter(String name);


    /**
     * 返回此servlet实例中封装所有初始化参数的<code>Enumeration</code>对象.
     * 如果servlet没有初始化参数,则返回一个空的
     * <code>Enumeration</code> 枚举值(但不是null).
     * 
     *
     * @return	Enumeration	含有servlet初始化参数的 <code>String</code>
     *			对象类型的<code>Enumeration</code>枚举值.
  
     */

    public Enumeration getInitParameterNames();


}
